<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkText</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
<link rel="home" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkProgress.html" title="GtkProgress">
<link rel="next" href="GtkTooltips.html" title="GtkTooltips">
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="Builder.html" title="Interface builder">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
<link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="api-index-full.html" title="Index of all symbols">
<link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
<link rel="index" href="api-index-2-2.html" title="Index of new symbols in 2.2">
<link rel="index" href="api-index-2-4.html" title="Index of new symbols in 2.4">
<link rel="index" href="api-index-2-6.html" title="Index of new symbols in 2.6">
<link rel="index" href="api-index-2-8.html" title="Index of new symbols in 2.8">
<link rel="index" href="api-index-2-10.html" title="Index of new symbols in 2.10">
<link rel="index" href="api-index-2-12.html" title="Index of new symbols in 2.12">
<link rel="index" href="api-index-2-14.html" title="Index of new symbols in 2.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkProgress.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkTooltips.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkText.synopsis" class="shortcut">Top</a>
                 | 
                <a href="#GtkText.description" class="shortcut">Description</a>
                 | 
                <a href="#GtkText.object-hierarchy" class="shortcut">Object Hierarchy</a>
                 | 
                <a href="#GtkText.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                 | 
                <a href="#GtkText.properties" class="shortcut">Properties</a>
                 | 
                <a href="#GtkText.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkText"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkText.top_of_page"></a>GtkText</span></h2>
<p>GtkText — A text widget</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkText.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gtk/gtk.h&gt;

                    <a class="link" href="GtkText.html#GtkText-struct" title="GtkText">GtkText</a>;
                    <a class="link" href="GtkText.html#GtkTextFont" title="GtkTextFont">GtkTextFont</a>;
                    <a class="link" href="GtkText.html#GtkPropertyMark" title="GtkPropertyMark">GtkPropertyMark</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a class="link" href="GtkText.html#gtk-text-new" title="gtk_text_new ()">gtk_text_new</a>                        (<a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *hadj,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *vadj);
void                <a class="link" href="GtkText.html#gtk-text-set-editable" title="gtk_text_set_editable ()">gtk_text_set_editable</a>               (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> editable);
void                <a class="link" href="GtkText.html#gtk-text-set-word-wrap" title="gtk_text_set_word_wrap ()">gtk_text_set_word_wrap</a>              (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> word_wrap);
void                <a class="link" href="GtkText.html#gtk-text-set-line-wrap" title="gtk_text_set_line_wrap ()">gtk_text_set_line_wrap</a>              (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> line_wrap);
void                <a class="link" href="GtkText.html#gtk-text-set-adjustments" title="gtk_text_set_adjustments ()">gtk_text_set_adjustments</a>            (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *hadj,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *vadj);
void                <a class="link" href="GtkText.html#gtk-text-set-point" title="gtk_text_set_point ()">gtk_text_set_point</a>                  (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> index);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               <a class="link" href="GtkText.html#gtk-text-get-point" title="gtk_text_get_point ()">gtk_text_get_point</a>                  (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               <a class="link" href="GtkText.html#gtk-text-get-length" title="gtk_text_get_length ()">gtk_text_get_length</a>                 (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);
void                <a class="link" href="GtkText.html#gtk-text-freeze" title="gtk_text_freeze ()">gtk_text_freeze</a>                     (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);
void                <a class="link" href="GtkText.html#gtk-text-thaw" title="gtk_text_thaw ()">gtk_text_thaw</a>                       (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);
void                <a class="link" href="GtkText.html#gtk-text-insert" title="gtk_text_insert ()">gtk_text_insert</a>                     (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Fonts.html#GdkFont"
>GdkFont</a> *font,
                                                         const <a
href="/usr/share/gtk-doc/html/gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> *fore,
                                                         const <a
href="/usr/share/gtk-doc/html/gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> *back,
                                                         const char *chars,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> length);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GtkText.html#gtk-text-backward-delete" title="gtk_text_backward_delete ()">gtk_text_backward_delete</a>            (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> nchars);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="GtkText.html#gtk-text-forward-delete" title="gtk_text_forward_delete ()">gtk_text_forward_delete</a>             (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> nchars);
#define             <a class="link" href="GtkText.html#GTK-TEXT-INDEX--CAPS" title="GTK_TEXT_INDEX()">GTK_TEXT_INDEX</a>                      (t, index)
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
   +----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkOldEditable.html" title="GtkOldEditable">GtkOldEditable</a>
                           +----GtkText
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkText implements
 AtkImplementorIface,  <a class="link" href="gtk-gtkbuildable.html#GtkBuildable">GtkBuildable</a> and  <a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkText.html#GtkText--hadjustment" title='The "hadjustment" property'>hadjustment</a>"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>*        : Read / Write
  "<a class="link" href="GtkText.html#GtkText--line-wrap" title='The "line-wrap" property'>line-wrap</a>"                <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkText.html#GtkText--vadjustment" title='The "vadjustment" property'>vadjustment</a>"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>*        : Read / Write
  "<a class="link" href="GtkText.html#GtkText--word-wrap" title='The "word-wrap" property'>word-wrap</a>"                <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="GtkText.html#GtkText-set-scroll-adjustments" title='The "set-scroll-adjustments" signal'>set-scroll-adjustments</a>"                         : Run Last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.description"></a><h2>Description</h2>
<p>
</p>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p>
<a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol <code class="literal">GTK_ENABLE_BROKEN</code>
prior to including the GTK+ header files. Use <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> instead.
</p>
</div>
<p>
A <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget allows one to display any given text and manipulate it
by deleting from one point to another, selecting a region, and various
other functions as outlined below.  It is inherited from <a class="link" href="GtkEditable.html" title="GtkEditable"><span class="type">GtkEditable</span></a>.
</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="GtkText-struct"></a><h3>GtkText</h3>
<pre class="programlisting">typedef struct _GtkText GtkText;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkText</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Most of the <a class="link" href="GtkText.html#GtkText-struct" title="GtkText"><span class="type">GtkText</span></a> struct members should not be accessed directly.
Listed below are a few exceptions and how to use them.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTextFont"></a><h3>GtkTextFont</h3>
<pre class="programlisting">typedef struct _GtkTextFont GtkTextFont;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkTextFont</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Internal <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> data type.

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkPropertyMark"></a><h3>GtkPropertyMark</h3>
<pre class="programlisting">typedef struct {
  /* Position in list. */
  GList* property;

  /* Offset into that property. */
  guint offset;

  /* Current index. */
  guint index;
} GtkPropertyMark;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkPropertyMark</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Internal <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> data type.  Should not be accessed directly.

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-new"></a><h3>gtk_text_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_text_new                        (<a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *hadj,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *vadj);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget, initialized with the given pointers to
<span class="type">GtkAdjustments</span>.  These pointers can be used to track the viewing position
of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.  Passing <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> to either or both of them will make
the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> create its own.  You can set these later with the function
<code class="function">gtk_text_set_adjustment()</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hadj</code></em> :</span></p></td>
<td>horizontal adjustment.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>vadj</code></em> :</span></p></td>
<td>vertical adjustment.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-set-editable"></a><h3>gtk_text_set_editable ()</h3>
<pre class="programlisting">void                gtk_text_set_editable               (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> editable);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_editable</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets whether the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget can be edited by the user or not.  This
still allows you the programmer to make changes with the various <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a>
functions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>editable</code></em> :</span></p></td>
<td>%TRUE makes it editable, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> makes it immutable by the user
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-set-word-wrap"></a><h3>gtk_text_set_word_wrap ()</h3>
<pre class="programlisting">void                gtk_text_set_word_wrap              (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> word_wrap);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_word_wrap</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets whether the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget wraps words down to the next line if it
can't be completed on the current line.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>word_wrap</code></em> :</span></p></td>
<td>%TRUE makes it word wrap, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> disables word wrapping
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-set-line-wrap"></a><h3>gtk_text_set_line_wrap ()</h3>
<pre class="programlisting">void                gtk_text_set_line_wrap              (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> line_wrap);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_line_wrap</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Controls how <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> handles long lines of continuous text.  If line wrap
is on, the line is broken when it reaches the extent of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
viewing area and the rest is displayed on the next line.  If it is not set,
the line continues regardless size of current viewing area.  Similar to word
wrap but it disregards word boundaries.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>line_wrap</code></em> :</span></p></td>
<td>%TRUE turns line wrap on, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> turns it off
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-set-adjustments"></a><h3>gtk_text_set_adjustments ()</h3>
<pre class="programlisting">void                gtk_text_set_adjustments            (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *hadj,
                                                         <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *vadj);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_adjustments</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Allows you to set <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> pointers which in turn allows you to
keep track of the viewing position of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>hadj</code></em> :</span></p></td>
<td>the horizontal adjustment
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>vadj</code></em> :</span></p></td>
<td>the vertical adjustment
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-set-point"></a><h3>gtk_text_set_point ()</h3>
<pre class="programlisting">void                gtk_text_set_point                  (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> index);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_set_point</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the cursor at the given point.  In this case a point constitutes
the number of characters from the extreme upper left corner of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a>
widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
<td>the number of characters from the upper left corner
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-get-point"></a><h3>gtk_text_get_point ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_text_get_point                  (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_get_point</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Gets the current position of the cursor as the number of characters from
the upper left corner of the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the number of characters from the upper left corner
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-get-length"></a><h3>gtk_text_get_length ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_text_get_length                 (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_get_length</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the length of the all the text contained within the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget;
disregards current point position.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the length of the text
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-freeze"></a><h3>gtk_text_freeze ()</h3>
<pre class="programlisting">void                gtk_text_freeze                     (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_freeze</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Freezes the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget which disallows redrawing of the widget until
it is thawed.  This is useful if a large number of changes are going to
made to the text within the widget, reducing the amount of flicker seen
by the user.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-thaw"></a><h3>gtk_text_thaw ()</h3>
<pre class="programlisting">void                gtk_text_thaw                       (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_thaw</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Allows the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget to be redrawn again by GTK.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-insert"></a><h3>gtk_text_insert ()</h3>
<pre class="programlisting">void                gtk_text_insert                     (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Fonts.html#GdkFont"
>GdkFont</a> *font,
                                                         const <a
href="/usr/share/gtk-doc/html/gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> *fore,
                                                         const <a
href="/usr/share/gtk-doc/html/gdk/gdk-Colormaps-and-Colors.html#GdkColor"
>GdkColor</a> *back,
                                                         const char *chars,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> length);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_insert</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts given text into the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget with the given properties as
outlined below.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>font</code></em> :</span></p></td>
<td>the <a
href="/usr/share/gtk-doc/html/gdk/gdk-Fonts.html#GdkFont"
><span class="type">GdkFont</span></a> to use
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>fore</code></em> :</span></p></td>
<td>the foreground color to insert with
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>back</code></em> :</span></p></td>
<td>the background color to insert with
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>chars</code></em> :</span></p></td>
<td>the actual text to be inserted
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>the length of the text to be inserted, passing -1 makes it insert
all the text.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-backward-delete"></a><h3>gtk_text_backward_delete ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_text_backward_delete            (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> nchars);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_backward_delete</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deletes from the current point position backward the given number of
characters.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>nchars</code></em> :</span></p></td>
<td>the number of characters to delete
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>%TRUE if the operation was successful, otherwise returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-text-forward-delete"></a><h3>gtk_text_forward_delete ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_text_forward_delete             (<a class="link" href="GtkText.html" title="GtkText">GtkText</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> nchars);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_text_forward_delete</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deletes from the current point position forward the given number of
characters.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>nchars</code></em> :</span></p></td>
<td>the number of characters to delete
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>%TRUE if the operation was successful, otherwise returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GTK-TEXT-INDEX--CAPS"></a><h3>GTK_TEXT_INDEX()</h3>
<pre class="programlisting">#define             GTK_TEXT_INDEX(t, index)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GTK_TEXT_INDEX</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the character at the given index within the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>t</code></em> :</span></p></td>
<td>the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
<td>the number of characters from the upper left corner
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.property-details"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="GtkText--hadjustment"></a><h3>The <code class="literal">"hadjustment"</code> property</h3>
<pre class="programlisting">  "hadjustment"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>*        : Read / Write</pre>
<p>
Used by the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget to keep track of the size of its horizontal
text.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkText--line-wrap"></a><h3>The <code class="literal">"line-wrap"</code> property</h3>
<pre class="programlisting">  "line-wrap"                <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
Boolean value indicating whether line wrap is enabled or not.
</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkText--vadjustment"></a><h3>The <code class="literal">"vadjustment"</code> property</h3>
<pre class="programlisting">  "vadjustment"              <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a>*        : Read / Write</pre>
<p>
Used by the <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a> widget to keep track of the size of its vertical
text.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkText--word-wrap"></a><h3>The <code class="literal">"word-wrap"</code> property</h3>
<pre class="programlisting">  "word-wrap"                <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
Boolean value indicated whether word wrap is enabled or not.
</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkText.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="GtkText-set-scroll-adjustments"></a><h3>The <code class="literal">"set-scroll-adjustments"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkText.html" title="GtkText">GtkText</a>       *text,
                                                        <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *arg1,
                                                        <a class="link" href="GtkAdjustment.html" title="GtkAdjustment">GtkAdjustment</a> *arg2,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>       user_data)      : Run Last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg2</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.11</div>
</body>
</html>
